home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / dis.z / dis
Text File  |  1998-10-30  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. DDDDIIIISSSS((((1111))))                                                                  DDDDIIIISSSS((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      dis - disassemble an object file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ddddiiiissss [ options ] file
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _d_i_s disassembles object files into machine instructions. The options are
  16.      as follows:
  17.  
  18.      ----bbbb  _b_e_g_i_n_a_d_d_r_e_s_s
  19.               disassemble starting at the given address.  The address can be
  20.               in decimal, octal (with a leading 0), or hexadecimal (with a
  21.               leading 0x).
  22.  
  23.      ----dddd   sssseeeeccccttttiiiioooonnnn
  24.               disassemble the named section as data, printing the offset from
  25.               the beginning of the section.
  26.  
  27.      ----CCCC       demangle C++ names.
  28.  
  29.      ----DDDD  _s_e_c_t_i_o_n
  30.               disassemble the named section as data, printing the actual
  31.               address of the data.
  32.  
  33.      ----eeee  _e_n_d_a_d_d_r_e_s_s
  34.               disassembly stops at the given address.  The address can be in
  35.               decimal, octal (with a leading 0), or hexadecimal (with a
  36.               leading 0x).
  37.  
  38.      ----FFFF  _f_u_n_c_t_i_o_n
  39.               disassemble the named function only in each object file
  40.               specified on the command line.  This option may be specified
  41.               multiple times on the command line.
  42.  
  43.      ----ffff       prefixes the line number on disassembly lines with the source
  44.               file basename.
  45.  
  46.      ----hhhh       substitute the general register names for the software register
  47.               names in the output.
  48.  
  49.      ----HHHH       remove the leading source line, leaving hex value and the
  50.               instructions.
  51.  
  52.      ----iiii       remove the leading source line and hexadecimal value of
  53.               disassembly, leaving only the instructions.
  54.  
  55.      ----IIII  _d_i_r_e_c_t_o_r_y
  56.               use the _d_i_r_e_c_t_o_r_y to help find the source code.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDIIIISSSS((((1111))))                                                                  DDDDIIIISSSS((((1111))))
  71.  
  72.  
  73.  
  74.      ----llll  _s_t_r_i_n_g
  75.               disassemble the archive file specified by _s_t_r_i_n_g.  For example,
  76.               ddddiiiissss ----llll xxxx would add _u_s_r/_l_i_b/_l_i_b_x._a to the files to be
  77.               disassembled.
  78.  
  79.      ----LLLL       look up source labels for subsequent printing.  This option
  80.               works only if the file was compiled with debugging information.
  81.  
  82.      ----oooo       print addresses and contents in octal.  The default is
  83.               hexadecimal.
  84.  
  85.      ----pppp   ffffuuuunnnnccccttttiiiioooonnnn
  86.               Exactly the same meaning as _----_FFFF _f_u_n_c_t_i_o_n
  87.  
  88.      ----ppppiiiixxxxiiiieeee   For pixie(1)d files, display original and pixified instructions
  89.               intermixed with source.  This is the default with pixified
  90.               files, so this option is unnecessary and obsolete and will
  91.               eventually be removed.
  92.  
  93.      ----ssss       Attempts to print j, jal target names.  Not very relevant since
  94.               with PIC code j, jal are little used.  This is the default
  95.               unless the ----ssssvvvvrrrr4444 option is given.
  96.  
  97.      ----ssssvvvvrrrr4444    Print using svr4 output format.  This means (if no other options
  98.               given) no externals are named (when loading data off of the $gp
  99.               register).
  100.  
  101.      ----SSSS       display source code intermixed with the assembly code.  There is
  102.               no guarantee that the source code displayed is the source code
  103.               used to compile the function, since _d_i_s simply looks for a
  104.               source file starting with name/path given in the object and
  105.               continuing by looking in directories specified with -_I (if any)
  106.               and accepts the first appropriately-named file it finds as the
  107.               source file.  If ----SSSS is repeated on the command line _d_i_s will, in
  108.               addition, name the source file involved (with whatever path was
  109.               used to acess the file), as in the example "Skipping source
  110.               listing to line 10 of /b/t.c...".
  111.  
  112.      ----TTTT       trace flag is for debugging of the disassembler itself.
  113.  
  114.      ----tttt  _s_e_c_t_i_o_n
  115.               disassemble the named section as a text section.
  116.  
  117.      ----vvvv       attempts to print the names of inlined functions where the
  118.               function is inlined.  The information about inlines is not
  119.               always present in the debug information, so this option will not
  120.               always produce the inlined function names.
  121.  
  122.      ----VVVV       print the version of _d_i_s being executed.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. DDDDIIIISSSS((((1111))))                                                                  DDDDIIIISSSS((((1111))))
  137.  
  138.  
  139.  
  140.      ----wwww       attempts to print source information (names of user variables
  141.               involved) after (to the right of) assembly codes.  This option
  142.               comes into effect only if -_s is also specified, but does not
  143.               imply -_s.  (But recall from above that -s is on by default
  144.               unless -svr4 is specified, so -w is effective by itself unless
  145.               -svr4 was specified.)
  146.  
  147.      ----xxxx       prints offsets and constants in instructions as hex numbers.
  148.               The default is to print instruction offsets and constants as
  149.               decimal.
  150.  
  151.      If the ----dddd, ----DDDD or ----tttt options are specified, only those named sections from
  152.      each user-supplied filename will be disassembled.  Otherwise, all
  153.      sections containing text will be disassembled.
  154.  
  155. FFFFIIIILLLLEEEESSSS
  156.      /usr/bin/dis
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.